home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / ratbas.arc / RT.UM < prev    next >
Encoding:
Text File  |  1982-10-29  |  3.3 KB  |  78 lines
  1.                 PROGRAM RT
  2.  
  3.  
  4. This program translates a program written in the RATBAS language to an 
  5. equivalent program in BASIC. 
  6.  
  7. The program is run from DOS. To begin, simply type RT. For example:
  8.  
  9.      A> RT
  10.  
  11. The program will then request the name of the file with the source 
  12. code written in the RATBAS language (for details, see the entry under 
  13. RATBAS in the user's manual). You may give the file name with or 
  14. without a disk prefix. If no extension is given, .RAT is assumed. 
  15.  
  16. RT will next ask for the disk drive on which any referenced INCLUDE 
  17. files are to be found. This may be given with or without a colon. If 
  18. you press the carriage return, the default drive is assumed. 
  19.  
  20. Finally, RT will ask for the name of the BASIC program file to be 
  21. created. If you press the carriage return, the name will be the same 
  22. as that of the source file, but with a .BAS extension. 
  23.  
  24. There are three options.
  25.  
  26. If you follow the name of the source (RATBAS) file with a semicolon, 
  27. no further questions will be asked -- include files will be taken from 
  28. the default drive and the BASIC file will be given the same name as 
  29. the RATBAS file, but with a .BAS extension. 
  30.  
  31. If you follow the name of the source (RATBAS) file with "/N", the 
  32. BASIC program will be created with no line numbers except where needed 
  33. for GOSUB and GOTO statements. Such BASIC programs cannot be used with 
  34. the BASIC interpreter, but they can be used with the Compiler. Since 
  35. the compiler optimizes statements only from line number to line 
  36. number, it is desirable to create a BASIC program with this option 
  37. when you are ready to produce a compiled version (when using the 
  38. compiler, you must also use the "/N" option). 
  39.  
  40. If you follow the name of the source (RATBAS) file with "/T", the BASIC
  41. program will be stripped of comments and leading spaces.  This option may
  42. be necessary when translating a very large program with a single-sided
  43. disk drive.  The /T option may be used with the /N option.
  44.  
  45. While translating, RT produces a record of its progress. Each line in 
  46. the RATBAS program is represented at the terminal. Standard BASIC 
  47. statements are indicated by dots. Procedures are indicated by the 
  48. procedure name, preceded by the line number of the procedure in the 
  49. BASIC program. Lines referencing (calling) procedures are indicated by 
  50. "p". RATBAS IF statements are indicated by I; RATBAS ELSE statements 
  51. by "e"; and RATBAS IFEND statements by "i". RATBAS CASE statements are 
  52. indicated by "C", selections within a case by "s", OTHERWISE 
  53. statements by "o", and CEND statements by "c". When an Include file is 
  54. read or completed, a message is printed at the terminal. 
  55.  
  56. When RT encounters an error, a message is printed and the user is 
  57. given the option to continue or terminate. In many cases, continuation 
  58. leads to useful information; in some, however, errors compound and 
  59. subsequent "errors" are consequences of earlier ones. When errors are 
  60. encountered, the BASIC program should not be used. 
  61.  
  62. For compatability with the BASIC compiler, a RATBAS program should have
  63. the form:
  64.  
  65.      COMMON ....
  66.      DIM    ....
  67.  
  68.      PROCEDURE ...
  69.  
  70.      PROCEDURE ...
  71.  
  72.      PROCEDURE ...
  73.  
  74.      PROGRAM
  75.  
  76. For further details, see the entry under RATBAS in the user's manual.
  77.  
  78.